gRPC: Add gRPC interface to cardano-node with tests in cardano-testnet by carbolymer · Pull Request #6273 · IntersectMBO/cardano-node

carbolymer · 2025-07-04T15:37:47Z

Description

This PR adds an experimental gRPC endpoint to cardano-node. You can read architecture design here. For now the following methods are supported:

Query
- ReadParams
- ReadUtxos
Submit
- SubmitTx

The gRPC endpoint is disabled by default, can be enabled by CLI flag or by configuration option.

Support for enabling gRPC endpoint is added into cardano-testnet.

Things necessary to do before the merge:

Release cardano-cli to remove SRP
Release cardano-rpc to remove SRP

Checklist

Commit sequence broadly makes sense and commits have useful messages
New tests are added if needed and existing tests are updated. These may include:
- golden tests
- property tests
- roundtrip tests
- integration tests
  See Runnings tests for more details
Any changes are noted in the CHANGELOG.md for affected package
The version bounds in .cabal files are updated
CI passes. See note on CI. The following CI checks are required:
- Code is linted with hlint. See .github/workflows/check-hlint.yml to get the hlint version
- Code is formatted with stylish-haskell. See .github/workflows/stylish-haskell.yml to get the stylish-haskell version
- Code builds on Linux, MacOS and Windows for ghc-9.6 and ghc-9.12
Self-reviewed the diff

Note on CI

If your PR is from a fork, the necessary CI jobs won't trigger automatically for security reasons.
You will need to get someone with write privileges. Please contact IOG node developers to do this
for you.

Jimbo4350

Minor comments but I would solicit feedback from @jasagredo regarding the configuration change. Will approve after that is discussed.

Jimbo4350 · 2026-03-12T16:49:47Z

cardano-node/src/Cardano/Node/Configuration/POM.hs

       , pncResponderCoreAffinityPolicy :: !(Last ResponderCoreAffinityPolicy)
+
+         -- gRPC
+       , pncRpcConfig :: !PartialRpcConfig


Same here regarding the configuration being moved to consensus.

Jimbo4350 · 2026-03-12T16:50:05Z

cardano-node/src/Cardano/Node/Configuration/POM.hs

       , ncResponderCoreAffinityPolicy :: ResponderCoreAffinityPolicy
+
+         -- gRPC
+       , ncRpcConfig :: RpcConfig


Hmm. @jasagredo is working on moving the cardano node configuration machinery to ouroboros-consensus. To prevent future pain I would run this change by him.

cardano-testnet/test/cardano-testnet-golden/files/golden/help/cardano.cli

Jimbo4350 · 2026-03-12T16:53:25Z

cardano-node/src/Cardano/Node/Tracing/Tracers/Rpc.hs

+    mconcat $
+      ("reason" .= prettyShow tr)
+        : case tr of
+          TraceRpcFatalError _ -> ["kind" .= String "FatalError"]


Where can one see the reason for the fatal error?

It's above in line 29. I've made reason dumped for each trace.

In general, this is used for any initialisation exception: https://github.com/IntersectMBO/cardano-api/blob/2aa5ce77b1139d1d216c19eb4eb7b7a7e0e4e18b/cardano-rpc/src/Cardano/Rpc/Server.hs#L71

cardano-testnet/src/Testnet/Start/Types.hs

Jimbo4350 · 2026-03-12T18:46:03Z

cardano-testnet/test/cardano-testnet-test/Cardano/Testnet/Test/Rpc/Query.hs

+  ---------------------------
+  -- Test readParams response
+  ---------------------------
+  pparamsResponse ^. U5c.ledgerTip . U5c.slot === slot


How flaky is this test?

I have not observed flakiness. This test also runs with 2 retries, so if this happens, it should rerun. We could call cli and get the tip in parallel, but I'm not sure the gain here will be worth of complexity.

cardano-testnet/test/cardano-testnet-test/Cardano/Testnet/Test/Rpc/Query.hs

cardano-testnet/test/cardano-testnet-test/Cardano/Testnet/Test/Rpc/Transaction.hs

Jimbo4350 · 2026-03-12T18:53:04Z

cardano-testnet/test/cardano-testnet-test/Cardano/Testnet/Test/Rpc/Transaction.hs

+
+  txBody <- H.leftFail $ createTransactionBody sbe content
+
+  let signedTx = signShelleyTransaction sbe txBody [wit0]


I see we are using the "old" api. Fine for this PR but I'd like you to migrate to the new api if possible in a follow up PR.

cardano-testnet/test/cardano-testnet-test/Cardano/Testnet/Test/Rpc/Transaction.hs

Copilot

Pull request overview

Copilot reviewed 33 out of 34 changed files in this pull request and generated 5 comments.

Comments suppressed due to low confidence (1)

nix/pkgs.nix:1

previousAttrs.buildInputs is not guaranteed to exist on all derivations; if it's missing, Nix evaluation will fail. Safer pattern is to append to (previousAttrs.buildInputs or []) before adding prev.windows.pthreads.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

cardano-testnet/test/cardano-testnet-test/Cardano/Testnet/Test/Rpc/Transaction.hs

cardano-node/src/Cardano/Node/Run.hs

cardano-testnet/src/Parsers/Cardano.hs

cardano-node/src/Cardano/Node/Parsers.hs

carbolymer self-assigned this Jul 4, 2025

carbolymer changed the title ~~cardano-rpc | Add gRPC interface to cardano-node, add tests to cardano-testnet~~ cardano-rpc | Add gRPC interface to cardano-node with tests in cardano-testnet Jul 4, 2025

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch 2 times, most recently from 864cf20 to 12bae80 Compare July 10, 2025 15:37

This was linked to issues Jul 11, 2025

gRPC: UTxORPC SubmitTx method of submit service #6246

Closed

gRPC: Command-line and configuration flags for cardano-rpc settings in cardano-node #6247

Open

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch from 0004d02 to 2c89086 Compare July 23, 2025 14:20

carbolymer mentioned this pull request Jul 24, 2025

cardano-rpc | Add UTxO RPC: submitTx method IntersectMBO/cardano-api#905

Merged

3 tasks

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch 3 times, most recently from aaab28c to eab2ed1 Compare July 25, 2025 16:57

palas force-pushed the mgalazyn/feature/add-grpc-interface branch 4 times, most recently from 4d19d4c to 98d8073 Compare August 3, 2025 20:00

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch from 12d7ab5 to 73c37e6 Compare September 4, 2025 16:45

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch from 8cbf3f2 to 0ec9ea7 Compare October 2, 2025 12:29

carbolymer added this to DevTools roadmap Nov 13, 2025

carbolymer changed the title ~~cardano-rpc | Add gRPC interface to cardano-node with tests in cardano-testnet~~ gRPC: Add gRPC interface to cardano-node with tests in cardano-testnet Nov 13, 2025

This was linked to issues Nov 13, 2025

gRPC: UTxORPC ReadParams method of query service #6251

Closed

gRPC: UTxORPC readUtxos method of query service #6363

Closed

carbolymer removed this from DevTools roadmap Nov 13, 2025

carbolymer linked an issue Nov 13, 2025 that may be closed by this pull request

gRPC: Integration of gRPC metrics into cardano-node tracing and monitoring system #6254

Open

carbolymer removed a link to an issue Nov 13, 2025

gRPC: Integration of gRPC metrics into cardano-node tracing and monitoring system #6254

Open

carbolymer linked an issue Nov 13, 2025 that may be closed by this pull request

gRPC: Integration of gRPC logging into cardano-node tracing system #6365

Open

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch 2 times, most recently from 7c29f29 to ebf5f8b Compare November 17, 2025 08:33

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch 2 times, most recently from a8564a9 to 5d772e5 Compare November 28, 2025 20:50

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch from 5d772e5 to 450a849 Compare January 7, 2026 18:51

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch 6 times, most recently from 86ec635 to 9984a35 Compare February 24, 2026 17:13

carbolymer requested a review from Copilot February 24, 2026 17:13

Copilot started reviewing on behalf of carbolymer February 24, 2026 17:14 View session

This comment was marked as outdated.

Sign in to view

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch 4 times, most recently from 7b30930 to 8e67434 Compare February 26, 2026 14:55

carbolymer changed the title ~~WIP: gRPC: Add gRPC interface to cardano-node with tests in cardano-testnet~~ gRPC: Add gRPC interface to cardano-node with tests in cardano-testnet Mar 2, 2026

carbolymer force-pushed the mgalazyn/feature/add-grpc-interface branch 3 times, most recently from 2ea442d to 8f6a3b7 Compare March 9, 2026 16:26

This comment was marked as outdated.

Sign in to view

Jimbo4350 mentioned this pull request Mar 12, 2026

cardano-testnet: Replace eon-based era witnesses with Exp.IsEra/Era #6487

Open

Jimbo4350 reviewed Mar 12, 2026

View reviewed changes

carbolymer added 7 commits March 13, 2026 16:03

Add cardano-rpc cabal dependency

f87b8a8

Add cardano-rpc configuration to node configuration file

13b5255

Add cardano-rpc tracing

e3a5465

Add cardano-rpc to node startup

971fb11

Add cardano-rpc support in cardano-testnet

9ad4fb5

Add cardano-rpc tests in cardano-testnet

c83492f

Add cardano-testnet changelog entry

54c0d9e

Copilot AI reviewed Mar 13, 2026

View reviewed changes


		txBody <- H.leftFail $ createTransactionBody sbe content

		let signedTx = signShelleyTransaction sbe txBody [wit0]

Conversation

carbolymer commented Jul 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Note on CI

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

Jimbo4350 left a comment

Choose a reason for hiding this comment

Uh oh!

Jimbo4350 Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

Jimbo4350 Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Jimbo4350 Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

carbolymer Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Jimbo4350 Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

carbolymer Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Jimbo4350 Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

carbolymer Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

carbolymer commented Jul 4, 2025 •

edited

Loading

Jimbo4350 Mar 12, 2026 •

edited

Loading